home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Developer Toolbox 6.1
/
SGI Developer Toolbox 6.1 - Disc 4.iso
/
src
/
README
< prev
Wrap
Text File
|
1994-08-01
|
24KB
|
368 lines
~4Dgifts/toolbox/src README
This subtree is breaks down into the following components:
`!' indicates new additions or updated versions of as of version 4.2
apps application packages. Includes:
! cmapDoctor - scanner/viewer for all X colormaps/visuals
including overlays, underlays and popups;
! gmemusage - graphical memory usage display tool;
! gvi -- Vk-based graphical UI to the vi(1) text editor;
ibrowse -- An image file browser;
opaste -- A tool for pasting images into the
overlay/popup planes;
! pcnfsd -- PC-NFS daemon provides access for IRIX users
of authentication and print spooling services
from a PC.
xconf -- Local area network conferencing program;
demos Selected demo source code of 45 of SGI's best:
- OpenGL-based: atlantis, backtrace, drip, fadeflip, ideas,
insect, lorenz, puzzle, space, stonehenge, tex_cube,
- Irix 4 GLX-based video: specialfx, vidtmesh, vidpaint,
trails, bigvideoin,
- Irix 4 GLX-based: demobook,
- Iris GL: atlantis, bounce, buttonfly, closeup, curve,
demograph, dragon, flight, flip, ideas, logo, newave,
newton, rotimg, snoop, snurb,
- VGX-intended: blob, envmap, morph, shadows,
- audio: amesh, bz, drive, synthia,
- Reality Engine-intended: atom, distort, fastshadows, and
weather;
exampleCode gathered together here is a selection of source providing
what we hope are useful and informative examples including:
3Dmodeling -- routines to help build solid models;
! GLX -- mixed model programs (GL-Xlib & GL-Motif);
MP -- multi-processing/parallel computing examples;
SciTex - paper + code on "Texture Mapping in Technical,
Scientific & Engineering Visualization";
! X -- * "Font" and "Pixmap" cursors example programs;
! * glpyh and scalable fonts example programs;
* Xserver: 4 PostScript documents on SGI's X server
papers + accompanying sample src;
! * xshowcmap extension, useful in debugging problems
dealing with multiple colormaps and/or visuals;
! * XtAppInitwIcon: generates multi-color icons.
audio -- code implementing lib*audio*.a:
* ascope: display left channel from /dev/audio;
* DAT examps: dodat: simple DAT command interface,
* cdtodat: CD-to-DAT copying examp,
* verifydat: simple DAT checking program;
! * harmonizer: real-time audio pitch bender program;
! * midi: example programs using libmidi.a;
! * sonic: real-time audio spatialization w/graphics;
* reverb: simulated reverberation for real-time
audio input and output;
* rock: indigo memorial barbeque theme song rapp;
* somePlayback: generate oscillators, waveforms,
chng playback rate, mix, chng pitch, loop samples
& output to speaker;
* tablenet: generate small series of waveforms and
write them into a 16-bit AIFF file;
* "Audio Interchange File Format AIFF-C, A revision
to include compressed audio data" document;
calc -- a Reverse Polish Notation calculator;
cap -- technique for "capping" a clipped solid obj;
csg -- a paper on and an implementation of constructive
solid geometry;
fconv -- a Motif-based numeric format conversion utility for
hex, octal and decimal equivalents.
games -- contains source code for different gfx/audio game
software, including IndiZone games:
! * vroom: swank opengl slot car racing in the future;
* blix: the mighty mouse hero of indizone,
* cycles: solo || multiplayer (network) motorcycles
* gold: synthetic fish bowl simulation,
* oort: vehicular combat on an asteroid,
* portfolio: stock observation program,
* sw: (Spacewar) combat in space,
* tagh: variation on the children's game of tag,
as well as other perennial favorites:
* buzzwordBingo: all-time SGI hit, buzzword bingo,
* cubetris: a 3D IRIS GL tetris game,
* seahaven: pure Xlib C++ graphical solitare card
playing game;
i18n -- internationalization & localization examples with
wide characters for string manipulation as well
as XPG/3 and MNLS message cataloging;
inventor -- contains documents and src examples including:
! * OpenIV prog uses draggers for direct manipulation
of surface of revolution (w/its own run-time DSO);
! * Open Inventor files demo an interactive direct
manipulation of a Track Light;
! * modified inventor_dev.src.sample src implements
handling for the Spaceball input device;
! * sample OpenIV files demo'ing use of draggers and
engines in "self-manipulating" examples;
! * html documentation files--FAQ + Known Bugs, Fixes,
and Workarounds--from Silicon Surf www site;
* easy-to-use 3D obj-modeler rich in Open Inventor,
* PostScript "How to Write an Open Inventor File
Translator" document,
* hands-on lab + solutions for Open Inventor 2.0
+ 38-page showcase document on the Open Inventor
3d Toolkit,
* PostScript "Quick Reference Guide" on Open
Inventor nodes and the Inventor file format,
* extension of SceneViewer enabling 2 or more people
on the same net to access the same input file
simultaneously & immediately see each other's
changes,
* soundspheres: Open Inventor-version of a very
primitive spacial audio program,
* Open Inventor versions of two example "template"
programs for a Walk Viewer and a Player,
* Open Inventor-version of a full function infix
calculator with audio, textures, etc,
* additional Inventor 1.1.2 Nodes--Audio & Highlight
--plus audio and Inventor Classes--Play and
Record, and Inventor Spline,
* DxfToIv binary+man pg--convert DXF files to Inven;
irix -- new tree of irix-based/related/relative stuff:
* collection of docs relating to compilers, [p]make,
cshell,
* sproc/semaphore source implements raising a sub-
process's priority to circumvent preemption,
* scripts subtree of c-shell script utilities
providing shell programming "source"--11 general-
purpose, 11 rcs-specific,
* tools dir with irix/system -level programs:
Lastrev: get RCS rev.s/symbls info/print to stdout,
chktime: comp 2 file's mod. times ret'ing {-1|0|1},
getopt: enhanced version of the unix system call,
gettime: get last mod. time of file/write to stdout
gpasswd: like passwd, set the password for a group,
isIn: returns true/false if 1st param equal to
any other params on command line,
listWMres: list all resrcs known to w. manager,
printf: better than IRIX 5 one because it can
handle all the standard C types,
rcstime: returns time of last RCS upd in RCS file,
strlen: shell-equiv. of strlen(3C) subroutine,
unique: returns all params passed on the command
line removing any duplicates,
vacupd: reads/modifies data in vacation database
files,
! * uucpVadmin: now contains inst image as well as src
for UUCP vadmin tool, allowing GUI set up of UUCP
files and confirmation that comm. to modem is good;
networking -- example networking utility programs:
! * "HIPPI Performance on IRIX 5.2" white paper and
accompanying src files;
* ifaddress, prints link-level address of an
Ethernet or FDDI interface,
* rpcdemo, an example RPC client/server app,
! * short_timer, checks whether remote host responds
quickly, avoiding a long wait for a network timeout;
opengl -- OpenGL example progs+libs+docs including:
! * OpenGL Attribute Tester tests OpenGL functionality
on different platforms, with GUI to test most
changeable OpenGL attributes,
! * OpenGL Color Chooser Widget - libGLColorChooser.a,
identical to IRIS GL version found in libSgm,
! * implementation of picking in OpenGL w/features of
X overlay on top of an RGBA, double- and depth-
buffered window,
* 3 articles on "OpenGL and X", published in the "X
Journal," plus 6 accompanying program examples,
! plus updated renderboth.c program,
* 19 sample progs (2 implement iris-GL-type popup
menu functionality), 4 updated, 38 total--based
solely on Xlib,
* "debugHelper" provides a way to override DSO
functions to trace a program's OpenGL calls
without recompiling,
* OpenGL version of the Color Chooser Widget,
indentical in usage+functionality to IRIS GL
version of the widget in libSgm,
* dinomometer: synthetic modeling benchmark,
* new tree of GLX extensions (2 so far),
* sample progs based on the Motif widget, libGLw.a,
plus 2 new examps:
- textfun: poor-man's OpenGL font manager (uses
libXm.so only--no libGLw.a),
- xmblur: motion blur demo,
* nurbsTrim: makes a trimmed NURBS surface in
OpenGL and Inventor
* opengl motif-based interference checking demo,
* sample programs based on libtk+Xlib,
* on-line copy of all programs discussed in "The
OpenGL Programming Guide," book,
* isfast contains perf measure routines indicating
if a given OpenGL feature is fast or not,
* xglinfo displays info about an Xserver supporting
the OpenGL extension, especially wrt visuals,
* 3 PostScript files containing the OpenGL spec;
! smoke * Texture Mapped `smoke' special F/X implementation;
speech -- starting bonafide speech recognition subtree:
* beta inst images of speech_eoe/dev products,
* binary utilities enhance speech run-time envm;
* basic speech recognition example programs,
* lackey -- a speech aware application launcher,
providing an intro to using the speech API and
the arch. of the speech software system;
stencil -- 3 implementations drawing in the stencil planes;
stereo -- contains src for software-stereo-in-a-window ala
irix 5:
* 2 simple "boilerplate" stereo implementations
contained in 4 OpenGL/motif programs,
* software-stereo-in-a-window or "SoftStereo"
example code using libgl and libX11;
swirl -- texture map generator;
video -- contains apps implementing functionality for digital
video processing including:
* file listing software configurations for video
option products running 5.2 IRIX,
* scrollmon: creates realtime scrolling credits
(from either anti-aliased text or SGI rgb images)
or titles for video production,
* seqgrab: VL sequential frame accurate capture
source (Galileo/VLAN),
* security: security camera for stopframe and
motion detection,
! * simpleVideo: library + examples provide video
programmer w/simple programmatic interface on top
of the video library (VL),
* vidmap: demos live or movie video texture-mapped
to a polygon.
! viewkit -- contains program source for viewkit-based apps:
* VCal: a calendar program with alarms,
* builderExamples: progs written w/BuilderXcessory,
* xcontact: Address Book and/or Contact Mgmt prog,
PLUS other viewkit stuff in the toolbox:
~4Dgifts/toolbox/src/apps/cmapDoctor/cmapdoctor
~4Dgifts/toolbox/src/apps/gvi
~4Dgifts/toolbox/src/exampleCode/opengl/oat
~4Dgifts/toolbox/src/exampleCode/video/security
~4Dgifts/toolbox/src/exampleCode/irix/uucpVadmin
~4Dgifts/toolbox/utilities/uil2VK
haeberli This subtree contains updated versions of most of the "cool
graphics" software Paul discussed during his talk with Tom
Davis at SGI's May 1992 Developer's forum (previously made
available on the "Totally Insane (tm)" CD distributed at that
time). This subtree can be most properly subtitled "Graphics
Utilities and Libraries." README and README.overview provide
detailed breakdowns of what comprise's a "current slice of
the haeberli universe":
128env -- collection of spherical environment map images
128tex -- collection of small texture map images
abekas -- utilities from Abekas Video Systems
autopaint - autopaints rgb image into various "altered states"
compexp - compression explorer w/sliders to adjust
compression paramaters
enhance - swank image processing GUI makes use of libui.a
envmaps - cubical format environment maps
envtools - environment map tools
fonts -- outline fonts in our polygonal outline font fmt
fonttools - outline font tools
images -- IRIS images that can be "ipaste"d to the screen
imgtools - a collection of tools for dealing with images
imp -- "the new impressionist" -- an image paint program
impression - interactive tools to create painted
representations of scanned-in photos
include - files defining various data structs used by the libs
jpeg -- jpeg img [de]compression sw plus support to
manip SGI image files
leep -- software implementation of the LEEP projection
lib -- contains pre-built--rle, tri, ui, vor--libraries
libcan -- basic support for creation/manipulation of canvases
libgutil - a graphics utility library
libimage - a library for reading and writing images
! libtiff - a tiff image library (v3.3) plus tiff tools subdir
movie -- progs for compressing/decompressing streams of imgs
mpeg -- contains a public domain MPEG video software decoder
mtex -- img-processing app massages images for use as
texture maps
objects - a bunch of sgo objects
objtools - object tools
pstools - postscript processing tools for the IRIS
sgisep -- has been removed--see note below for "sgisep"
styline - create interactive hidden line drawing of a
geometric object
tools -- desktop and graphics utilities tools
tritest - decompose complex polygons into series of triangles
vidiot -- "video feedback" prog animates a face w/audio input
vidpan -- tools to control a Panasonic Video disc recorder
vidsony - " " " a SONY LVR-5000 Video disc recorder
vidtools - tools for processing streams of video images
vortest - example to document the structures in lib/libvor.a
printers software/info pertaining to printer technologies including:
* supported.devices.list: list of printers & scanners
supported by SGI with notes including which are supported
by Impressario;
* script enabling default lp printing to dump to lpr;
ps_fonts -- progs to confirm if a PS device can print all
the chars in the alphabets you want to use.
swtools Contains a software tools to facilitate your own development
and implementations including:
! * libdmalloc, debugging malloc lib useful for finding memory
corruption, uses DSOs to plug in different malloc library.
! * src + updated doc files for DWARF, a binary debugging-
information-format.
! * script lists exported functions in libs, and as "undef" to
ensure all unresolved symbols are accounted for.
! * MIPS ABI Information Directory in html format replete with
hyperlinks, in-line images, etc, including a FAQ on porting
to the MIPS ABI.
! * DSO subtree w/1993 forum slides -- now updated to include
information on 64-bit issues-- + 8 case studies in DSOs,
a compiler-DSO tricks file, 5.2-released PS version of
Chapter 3: "Dynamic Shared Objects" from ""The IRIX
System Programming Guide," and an example program demo'ing
the implementation and use of a DSO.
* dbcopy, contains a faster version of the memory copy
routines than is found in libc in 5.1 and before.
* gencall, generates high-level programming interface to the
MIPS calling convention on SGI machines allows programmer
to call any function specified by a call descrption at run
time (can be used by progs that do not know what the call
* a generic application providing a file-opening template
I/O interface to UNIX.
* undated script, new man page, and crpt.shar compilation of
the Kernel core file report generator.
* MakeSccsRCS "fax-able" covering Make(1)/Pmake(1) and SCCS,
Make(1)/Pmake(1) and RCS, and ftp location of GNUmake,j
* malloc_db, a heap trasher finder--a "malloc" debugger.
* mipsABI porting materials including:
- ABI porting Q&A in PS and on-line readable form
(inst-able images+srcs for the on-line reader),
- PostScript copy of the "MIPS Processor ABI Conformance
Guide Version 1.1.1" (the "Black Book"),
- porting examples, and
- a paper on "Constructing MIPS ABI Compliant Binaries on
the IRIX 5.x Operating System".
interface is at compile time).
* MMmalloc, plug in replacement of "libmalloc" (malloc(3X))
library--in general it is faster, more memory efficient and
has better functionality than the original libmalloc.
* Qustion-and-Answer" file of materials snarfed from various
external/internal-to-SGI news groups on compiler issues.
* tracebackCode, 2 progs give alt. implementations of function
which prints a stack traceback of the calling program.
Principally useful for debugging code that has gotten into
an `interesting' location. Since the functions return
normally, the application can continue to operate.
* a fully functional version of the True BASIC language with
a 250-line limit on programs.
* an X and System performance tips files.
tutorials A new set of sample programs implemented in OpenGL.
This software is included in SGI's Technical Education
courses, "OpenGL Programming 1 Course" (basics) and
"OpenGL Programming 2 Course" (more advanced).
Also includes Tom Davis' marvelous "geometer" program
illustrating concepts of 2-dimensional Euclidean and
projective geometry.
